home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / flashdl2.arc / FLASHDL.DOC next >
Encoding:
Text File  |  1987-04-13  |  10.6 KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                 FLASH! Auto Batch Download Generator
  9.  
  10.                         rev. 2.0  4/1987
  11.                           by Jinfu Chen
  12.  
  13.     This  program is a freeware,  you can used it freely  and  are
  14.     encouraged to distribute to anyone.  However, it is prohibited
  15.     to  sell  it for profit.  If you like to  contribute  you  are
  16.     always welcome and can mail to:
  17.  
  18.     Jinfu Chen
  19.     41 Riverbend Drive
  20.     Yarmouth, Maine 04096
  21.     I can also be reached at:
  22.     BBS         207-854-2687  (MANIAC)
  23.     CompuServe  72327,2434
  24.     GEnie       J.CHEN
  25.  
  26.           Source  code  of  the  program  in  Personal  Pascal  is
  27.     available  by sending a self-stamped envelop with a  formatted
  28.     disk plus $10 to the above address.
  29.  
  30.         This program will generate a DO  file for  FLASH! to auto-
  31.     logon to GEnie or CompuServe, download several files and auto-
  32.     logoff.  Therefore you can browse thru the file library in one
  33.     of  the networks and capture the filenames or file  numbers(in
  34.     GEnie) and logoff,  then use this program to create a DO file,
  35.     and  come back to Flash,  hit Alt-A then click on the DO  file
  36.     and go off to do something else. It's very handy expecially if
  37.     you  are  going  to download a lot of files.
  38.  
  39.         There  are several DO files available in both networks  to
  40.     allow  you browse thru files,  it is best to use this  program
  41.     with these DO files to save your online time.
  42.  
  43.         For  those of you who are familiar with revsion  1.0,  you
  44.     will  notice there are many changes.  Actually the program  is
  45.     rewritten  completely with GEM interface.  New  features  also
  46.     include addition of CompuServe(including three major  networks
  47.     access:  CompuServe itself,  Telnet,  and Tymnet). A LOGIN.DEF
  48.     will be generated to save username(id),  password,  as well as
  49.     network  phone numbers so that you don't have to type them  in
  50.     every  time when using the program like in rev  1.0.      
  51.  
  52.         To use the program,  just click on FLASHDL.PRG. First comes
  53.     the  copyright title.  Then the program checks if there  is  a
  54.     LOGIN.DEF  file  presented,  if does it will load in  all  the
  55.     information   in  it,   including  username(or  id)  in   both
  56.     CompuServe and GEnie,  passwords, and telephone access numbers
  57.     to GEnie,  CompuServe, Telnet, and Tymnet. If this file is not
  58.     in the same directory or you don't have one,  the program will
  59.     create one with arbitoray information on it. You can edit them
  60.     later(see  below).  LOGIN.DEF  also can be  resided  on  other
  61.     directory if you want.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.         Next a dialog box will come out with four buttons,  GENIE,
  72.     COMPUSERVE,  HELP,  and QUIT.  If you click on GENIE,  another
  73.     dialog  box  will come out with your  username,  password  and
  74.     GEnie's telephone access number in it. If you are using it the
  75.     first  time,  you  will have to change them to  whatever  they
  76.     suppose to be. If they are correct, click on OK button or just
  77.     hit  the  return  key  will  exit.  If  COMPUSERVE  option  is
  78.     selected,  an  alert box will come out with three  options  of
  79.     telephone access,  CompuServe,  Tymnet, and Telnet. Select the
  80.     one  you would like to use(usually if there is a  CompuServe's
  81.     local  access  node available you should choose  it  as  using
  82.     Tymnet  or  Telnet will add $2.00/hour  surcharge).  Then  the
  83.     logon  information dialog box will come out.  Again,  you  can
  84.     edit  the information in it or just hit return key to skip  if
  85.     they are correct. There is also a button to allow you save the
  86.     capture to a log file when finished.
  87.  
  88.         Once  you  input proper logon  information,  then  a  file
  89.     selector  will be on the screen asking for the DO filename  to
  90.     be generated. The default name is CIS_DL.DO for CompuServe and
  91.     GENEI_DL.DO  for  GEnie.  You can use whatever name  you  want
  92.     obviously.
  93.  
  94.         The  next dialog box will ask which file you are going  to
  95.     donwload from GEnie or CompuServe.  If it is from  GEnie,  the
  96.     first line in the box can be a file number or filename of  the
  97.     file to be downloaed from GEnie,  most people use file  number
  98.     as  it's easier to remember.  The second line is the  filename
  99.     you  would like to save the file into a disk.  When  finished,
  100.     there are two ways to exit the box:  if you have more files to
  101.     be download in one session,  you should click the  OK and MORE
  102.     button(the default one,  i.e.  just hit the return key),  this
  103.     will cause the dialog box come out again and ask for next file
  104.     number(name);  if you have enough files to be downloaded,  the
  105.     other  button   ENOUGH should be clicked.  There is  no  limit
  106.     control  in  the  program so you can generated a  DO  file  to
  107.     download one hundres files in one session but it is recommened
  108.     not  to  do  so.  You should decide this  with  common  sense.
  109.     Another point should be made is when finishing the first line,
  110.     the easy way to go to the second line is to use the Tab key or
  111.     the left arrow key or the down arrow key. Don't hit the return
  112.     key  if  the  second line is not done as CR is  used  for  the
  113.     default button, i.e, the  OK and MORE button.
  114.  
  115.         If you choose CompuServe,  the dialog box will be a little
  116.     different.  There  is  only  one  filename  to  be  typed  in.
  117.     CompuServe's filename is limited to one six characters long in
  118.     name   and  three  more  in  extension.   For  simplicity   of
  119.     programming and usage,  I choose to use the same name to  save
  120.     the file to a disk. The second line is a download library name
  121.     in CompuServe.  The format is DLn where n is a numerical value
  122.     from 0 to 99. Currently in CompuServe's Atari16 SIG, there are
  123.     DL0  to  DL9  and DL11 to DL13.  You will have to  type  in  a
  124.     filename AS WELL AS the DLn correctly,  otherwise, the DO file
  125.     won't  be  able to find a file in DL4 while it's  actually  in
  126.     DL2(this is really your responsibility). Again, you can select
  127.     the  (OK and MORE) or ENOUGH to exit the box.  The  DL  number
  128.     will  remain  the  same as the last one if you  have  used  it
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.     already so it is recommanded to type in all the filenames in a
  138.     same DL then type in the others in another DL and so  on.  You
  139.     can, of course, create a DO file with this program to download
  140.     a file in DL0 then switch to DL9 for another and come back  to
  141.     DL0.  The  program is smart enough to generate swicth  library
  142.     command  for  you  but  you will waste  time  to  do  so  when
  143.     online(you know it costs $$$!).
  144.  
  145.         Once  it's done,  you will retun back to the  main  menu
  146.     where you can choose GENIE,  COMPUSERVE,  HELP,  and QUIT. The
  147.     HELP, well, you can find out by yourself.
  148.  
  149.         If  you look at the DO file the  program  genereated,  you
  150.     will  find out the first line is used just to configurate  the
  151.     terminal:
  152.  
  153.      >BA 1200|>ST ON|>TR OFF|>SB 1|>PY NONE|>XM 8 C R|>MO AT|>CA ON|
  154.  
  155.     The terminal is set to the following configuration:
  156.          Baud rate       : 1200
  157.          Strip bit       : On
  158.          Stop bit        : 1
  159.          Parity          : None
  160.          Translation     : Off
  161.          Xmodem          : 8 bit, CRC, 128 block
  162.          Monitor         : Atari (VT52)
  163.          Capture         : On
  164.  
  165.         It's not neccessory to do so everytime but I do it just in
  166.     case  you  have  used some  rare  configuration  right  before
  167.     calling GEnie or CompuServe. For 2400 baud and 300 baud users,
  168.     you will have to delete the first command '>BA 1200' (sorry  I
  169.     am  not in the fastest lane yet and say goodbye to  300  quite
  170.     sometime ago).
  171.  
  172.         When  using  GEnie,  the DO file will have  a  command  to
  173.     switch  to half duplex after logon(to hide your password  from
  174.     screen).  When using CompuServe, the duplex will be in full so
  175.     you really don't have to do it by yourself if you are  calling
  176.     two networks back and forth. Also when using CompuServe the DO
  177.     file will switch the terminal to Vidtex mode.
  178.  
  179.  
  180.     Cautions when using this program:
  181.  
  182.     1.  Since  the  Flash!  DO file  is  a  wait-a-prompt-then-do-
  183.     something  type,  it is very sensitive to the prompt the  host
  184.     sends. This may be a problem when using CompuServe if you have
  185.     customized prompts.  The DO file expects a standard ! prompt .
  186.     If  you  are  using others,  either edit the  DO  file  before
  187.     calling   or   change  the  prompts  back   to   the   default
  188.     one(prefered).
  189.  
  190.     2. The DO files the program generated are for the CompuServe's
  191.     Atari  ST  sig  (ATARI16)  as well as  the  GEnie's  Atari  ST
  192.     RoundTable.   You  can  use  it  to  generate  DO  files   for
  193.     CompuServe's  Atari  Developer  sig  (ATARIDEV)  and   GEnie's
  194.     MichTron Roundtable as well.  To do so,  just create a DO file
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.     like  before  and change the 'go atari16' in a  CompuServe  DO
  204.     file to 'go ataridev',  and the page number(476,  right  after
  205.     your  password) in a GEnie DO file to  491(MichTron's  library
  206.     page number).
  207.  
  208.     3.  The DO file the program generated will save files to  your
  209.     default  path which is the same as the one Flash!  resides  if
  210.     you have not set it other yet. You can set the default path to
  211.     somewhere else by selecting the set path menu in  Flash!,  for
  212.     example you can set it to a RAM disk to speed up saving  files
  213.     as  long as you don't forget to copy files back to  floppy  or
  214.     hard drive before turnning off the computer.
  215.  
  216.     4.  You should be aware of total file size to be download  and
  217.     the  available  space  of the disk to  save  file(s).  If  you
  218.     created  a  DO file to download 400k files total to  a  single
  219.     sided  disk  formatted  at 360k,  you will pay  for  your  own
  220.     consequency.
  221.  
  222.          Well,  that is all the features I can  think  off.  There
  223.     mightbe more(an inside joke for bug). Let me how you like. The
  224.     DO  file(s) can be used as a template also.  The way I  output
  225.     the download sequence is a line per file so you can just  edit
  226.     a DO file in any editor,  for instance,  the one in FLASH!  to
  227.     create  a  quick DO file without using  this  program.  I  was
  228.     plannig  to write an acc version but the final program is  too
  229.     large  for an acc.  Things can be changed if there are  enough
  230.     interestes. Enjoy downloading(don't forget to upload too!).
  231.  
  232.     Commercial Trademarks mentioned in this file:
  233.  
  234.     Atari ST, Flash!, CompuServe, GEnie, Personal Pascal.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.